WorldClient Pro © 1999-2000 Alt-N Technologies. All Rights Reserved.

 Creating Mail Server Accounts

 

WorldClient Pro works in conjunction with SMTP/POP3 email servers. When a user logs in to their WorldClient Pro account, WorldClient Pro will connect to the mail server on which they have an email account and then collect their messages from it. Therefore a WorldClient Pro user must have a valid email account on an email server before they can receive messages.

If you want all of your users to have their email account on a particular email server, you can configure WorldClient Pro to use an Add User utility that will automatically create a mail server account for each user when their WorldClient Pro account is created. When a user creates a WorldClient Pro account, this utility will automatically create an identical account on your mail server, and configure their WorldClient Pro account to collect messages from it. Check with your server's vendor to determine if they have an Add User utility for use with WorldClient Pro.

To enable WorldClient Pro to automatically create accounts on your mail server:

  1. In the NewMailExe parameter under the General section of WorldClient.ini, specify the file path to your Add User utility. You can edit the WorldClient.ini file by using the Administration Utility.

  2. Set the default domain name to be used with these accounts, i.e. the "domain.com" portion of "Frank@domain.com". This setting is called DefDomain and is located in the General section of the WorldClient.ini file. You can manually edit this file by using a text editor, or you can use the Remote Administration utility.

 

Creating Your Own Add User Utility
If an Add User utility is not available for your particular mail server, you may choose to create one for yourself. If you choose to write your own Add User program there are several things that you will need to incorporate into your program to insure that it will work properly with WorldClient Pro:

  1. WorldClient Pro will pass three parameters to your program for its use in creating the user's account: Account/Login, Password, and User's Full Name. These will be given on a single line in this order separated by spaces. The Full Name parameter will be contained in quotes.

    Example: Frank TMIL "Frank Thomas"

    The Account parameter must be one word with no spaces and is used as both the user's POP Login/Username and the mailbox portion of their email address, i.e. the "Frank" portion of "Frank@domain.com". This parameter must be used as the user's mailbox. If that particular name is already in use then your program should write a message stating that the address is taken and return 1 for failure (steps 2 and 3 below). Do not assign an alternate address if the one passed to your program is already taken. Furthermore, WorldClient Pro allows users to have spaces in their Account/Login parameter so be sure to account for this when constructing the Add User utility for your server. We suggest that you output an error message telling the user that spaces aren't allowed (see step 2 below).

    The Password parameter is the user's POP account password and must be one word with no spaces.

    The Full Name parameter will be contained in quotes and may be multiple words with spaces.

  2. Any output from your program must be written to Stdout. WorldClient Pro will display to the user this information on a web page. This is how you will let the user know the results of their attempt to create an account along with any additional information that you wish to provide. For example, if a particular login/mailbox is already taken, you will use this method to let the user know that they must try a different account name.

  3. Your program must return 0 if the account was created successfully, or 1 of it was unable to create an account for any reason. If an account couldn't be created, be sure to write a message to Stdout letting the user know before returning 1.

In WorldClient Pro:

  1. Set the default domain name to be used with these accounts, i.e. the "domain.com" portion of "Frank@domain.com". This setting is called DefDomain and is located in the General section of the WorldClient.ini file. You can manually edit this file by using a text editor, or you can use the Remote Administration interface.

  2. In the NewMailExe parameter under the General section of WorldClient.ini, specify the file path to your Add User utility. You can edit the WorldClient.ini file by using the Remote Administration interface.

 

See Also:

Creating MDaemon Accounts

Importing Your Windows NT Users

Importing Accounts From a Text File